═══ 1. Product information ═══ WebWriter/2 Version 1.1 An HTML editor for OS/2 Don't write Home without it! Written by John Blumel Copyright (c) 1995, 1996 John Blumel All rights reserved WebWriter/2 is an HTML editor designed and written for OS/2. WebWriter/2's Multithreaded design allows you to open and edit multiple documents at once. Full support of HTML 2.0, including non-English characters, is provided. In addition WebWriter/2 also supports most of the HTML 3.0 extensions implemented in the IBM WebExplorer & Netscape Navigator. You can markup documents by selecting elements from menus or from the Tag manager dialog. WebWriter/2 provides drag & drop Workplace Shell integration and allows configuration of multiple applications to preview your HTML documents. Thank you for trying WebWriter/2. I hope you find it both useful and easy to use. If you have suggestions for enhancements or useability improvements, or if you discover defects in WebWriter/2, please contact me through one of the methods listed under Technical Support. Additional product information is available on the following topics:  License agreement  Registering WebWriter/2  Technical support and contacting the author Acknowledgements: Special thanks to my wife, Miriam Corti, for creating the WebWriter/2 icons. ═══ 1.1. License agreement ═══ WebWriter/2 Evaluation You may use WebWriter/2 for a period of up to 30 days for the purpose of determining, prior to purchase, if WebWriter/2 meets your needs. After this 30 day evaluation period, you must either register WebWriter/2 or stop using it WebWriter/2 Distribution You may make copies of and freely distribute WebWriter/2 subject to the following conditions.  You must include all of the files and only the files that were part of the original distribution copy of WebWriter/2 which you obtained.  If you give a copy of WebWriter/2 to another person you must inform them of the restrictions stated in the WebWriter/2 Evaluation section above.  You may not sell or distribute WebWriter/2 for a fee in excess of the costs actually incurred in doing so without the express written consent of the author. Limitations on Liability THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTY OF ANY KIND. UNDER NO CIRCUMSTANCES SHALL THE AUTHOR (John Blumel) BE LIABLE FOR ANY INCIDENTAL, SPECIAL OR CONSEQUENTIAL DAMAGES (INCLUDING DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION AND THE LIKE) ARISING OUT OF THE USE OR INABILITY TO USE THE SOFTWARE OR ITS DOCUMENTATION. ═══ 1.2. Registering WebWriter/2 ═══ WebWriter/2 v1.1 is free for registered users of previous versions. If you are currently a registered user, you do not need to register again and the registration information that you used previously is still valid. If you are not already a registered user and you decide that you wish to continue using WebWriter/2 beyond the 30 day evaluation period, you will need to register it. The registation fee is $30.00 U.S. When you register you will be sent a registration code. After you enter your registration information WebWriter/2 will display your name in the Product information dialog, the Registration menu will no longer appear on the Edit window menu bar and dialogs reminding you to register will no longer be displayed. All registered users are entitled to unlimited free technical support via email. Please print and fill out the register.txt file included with WebWriter/2. If the copy of WebWriter/2 you obtained did not include the register.txt file, send the following information:  Your name  Postal address  Email address  Phone (Home/Work)  WebWriter/2 version number  How you obtained WebWriter/2  Any other comments you may have To register send a check or money order in the amount of the registration fee(s) payable to John Blumel and drawn on a U.S. bank to: John Blumel 1949 Green Oak Drive Terrytown, LA 70056 USA For convenience of payment, you may register WebWriter/2 through BMT Micro. BMT Micro will accept the following forms of payment:  Visa  MasterCard  Discover  American Express  Money Order  Cashiers Check  Personal Check Checks and money orders should be made payable to BMT Micro. Registration through BMT Micro may be done in any of the following ways: Mail Orders: BMT Micro 452 Horn Road Wilmington, NC 28412-2411 U.S.A. Voice Orders: 9:00am - 7:00pm EST (-5 GMT) (800) 414-4268 (orders only) (910) 791-7052 Fax Orders: (910) 350-2937 24 hours / 7 Days (800) 346-1OS2 (1672) In the US and Canada Telnet: bmt.wilmington.net BBS: (910) 350-8061 10 lines, all 14.4K (910) 799-0923 Direct 28.8K line If you wish to place the order through BMT Micro via Mail or Fax, please print and fill out the BMTOrder.txt file which was included in the WebWriter/2 archive. Corporations and/or organizations interested in site licenses should contact the author prior to registering. ═══ 1.3. Technical support and contacting the author ═══ Requests for technical support, suggestions, license inquiries, or bug reports should be directed to: jblumel@gs.net Or: John Blumel 1949 Green Oak Drive Terrytown, LA 70056 USA ═══ 2. Using WebWriter/2 ═══ WebWriter/2 allows you to create HTML documents from scratch or to markup existing text documents. Full support is provided for the creation of HTML version 2.0 documents as well as supporting many HTML 3.0 features. It also includes the capability for the user to define tags which are not currently supported, allowing users to include tags from more recent HTML specifications or to define customized versions of existing tags. Full support is also provided for the ISO-Latin-1 character set through menu options and the Character manager dialog. You can edit multiple documents at once as well as preview your documents using the WWW client of your choice. At least some knowledge of HTML is assumed and no syntax checking of documents is performed. For information on a specific topic select one of the following:  Inserting HTML tags  Inserting HTML attributes  Inserting character entities  Editing multiple documents  Previewing documents  WebExplorer viewer for HTML source  HTML information ═══ 2.1. Inserting HTML tags ═══ To insert HTML tags, select the desired tag from the Tags menu. Tags which have additonal or optional elements may present the user with a dialog prompting for the necessary information. You can select tags and markup your text as you write it or you can first create the content for your HTML document and then focus on its presentation. Prompting for some HTML elements is optional. This is indicated by a [...] following the menu item text. You will be prompted for these items only when you hold down the Ctrl key while selecting the item. This allows you to work more quickly by bypassing the dialogs most of the time, yet, still providing access to prompting when you request it. Additional tags may be defined and inserted using the Tag manager dialog. The Tag manager dialog can be displayed by selecting the Tags/More tags... menu option. When inserting HTML tags, selected text will be wrapped by the tag if it is two sided. One sided tags are inserted before selected text. ═══ 2.2. Inserting HTML attributes ═══ To insert HTML attributes, select the desired attributes from the Attributes menu. Attributes which have additional or optional elements may present the user with a dialog prompting for the necessary information. By providing support for HTML attributes separate from their associated tags, WebWriter/2 allows you the flexibility of being able to easily modify your documents formatting without having to resort to either typing the attributes in manually or having to first delete then reapply tags in order to change their attributes. Prompting for some HTML attributes is optional. This is indicated by a [...] following the menu item text. You will be prompted for these items only when you hold down the Ctrl key while selecting the item. This allows you to work more quickly by bypassing the dialogs most of the time, yet, still providing access to prompting when you request it. HTML attributes are inserted before selected text. ═══ 2.3. Inserting character entities ═══ Character entities from the ISO-Latin-1 character set can be inserted by selecting the desired character entity or character accent from the Characters menu. Additional character entities are available in the Character manager dialog. The Character manager dialog can be accessed by selecting the Characters/More characters... menu option. Character entities are inserted before selected text. ═══ 2.4. Editing multiple documents ═══ WebWriter/2 uses a MSDI (Multiple Single Document Interface) method of editing multiple documents. You can open as many WebWriter/2 windows as you want as long as you can keep track of what you are doing. To open another WebWriter/2 window, select Windows/New window. To help manage your open documents you can display the WebWriter/2 Window manager. You can do this by selecting Windows/Window manager or by selecting it from the OS/2 window list. You can manage the open Edit windows by selecting options from the Window manager Windows menu or from the Window manager context menu. You can copy and paste selected text or entire documents from one Edit window to another by simply dragging from the source to the target window. ═══ 2.5. Previewing documents ═══ WebWriter/2 allows you to preview your HTML documents in the WWW client of your choice. The preview function will start the preview application you have selected and load the current document. If you are using the IBM WebExplorer or Netscape Navigator as your preview application and there is already a copy of running, WebWriter/2 will load the document into this already open window rather than starting a new copy of the program every time. This will work for Netscape only if it is configured to run in a WIN-OS/2 window. If you configure Netscape to run in a full screen WIN-OS/2, WebWriter/2 will still start a new copy for each preview. You can select and configure these applications via the Preview pages of the WebWriter/2 settings dialog. The applications that you select are displayed as choices in the File/Preview submenu. You can preview the current document by selecting one of these menu choices. You can also select another preview application on the fly by choosing File/Preview/Other... If you use the IBM WebExplorer, you can also preview a document by simply dragging it to an open WebExplorer window. WebWriter/2 has been tested with both the IBM WebExplorer (v1.03) and Netscape Navigator (v2.0b3). ═══ 2.6. WebExplorer viewer for HTML source ═══ If you use IBM's WebExplorer as your WWW client you can use WebWriter/2 as your viewer for HTML document source. To do this... 1. Choose Configure/Viewers from the WebExplorer menu bar. 2. Select viewer type Editor for HTML Source. 3. Specify WebWrite.EXE, including the path to it, as the viewer program. You can also select it using the Browse... button. 4. Click OK to save the setting. A faster way to use WebWriter/2 as a viewer for HTML source from WebExplorer is to drag the source from WebExplorer to an open WebWriter/2 window or the WebWriter/2 Window manager. To do this... 1. Hold down the Ctrl key and start dragging from the WebExplorer window. 2. After WebExplorer finishes preparing the source for dragging position it over an open WebWriter/2 edit window or the Window manager. 3. To open the source using the Window manager simply drop it there. 4. To open the source in an existing WebWriter/2 edit window: a. Release the Ctrl key. b. Hold down the Shift key. c. Drop the HTML source on the edit window. ═══ 2.7. HTML information ═══ If you are not familiar with HTML you may wish to obtain one of the many books available on this topic. Teach Yourself Web Publishing with HTML in a Week by Laura Lemay ( SAMS Publishing, 1995 ) is a good book for beginners. Also available from the same author is Teach Yourself More Web Publishing with HTML in a Week ( SAMS Publishing, 1995 ). There are also many WWW sites which provide up to date HTML documentation and examples. The WebWriter/2 readme file contains additional information on WWW sites which maintain information on the HTML specification. If you have a primary preview application configured, you can view an HTML version of this file by selecting Help/WebWriter/2 readme from the Edit window menus. Otherwise, you can view the readme.txt file located in the WebWriter/2 directory by loading it into any text editor, including WebWriter/2. For basic HTML 2.0 information, you can load the html20.htm file included with WebWriter/2 into your WWW client by selecting Help/HTML 2.0 reference from the Edit window menus. ═══ 3. WebWriter/2 key assignments ═══ The following keys may be used when editing document text in the WebWriter/2 edit window. Enter Start a new line by inserting an End-of-Line character at the insertion point. Ctrl+Enter Start a new paragraph by inserting an End-of-Line character and Paragraph tag (

) at the insertion point. Shift+Enter Start a new list item by inserting an End-of-Line character and List item tag (
  • ) at the insertion point. Tab Insert a tab character at the insertion point. Insert Switch between insert and overtype mode. Backspace Deletes the previous character or, if text is selected, deletes the selected text. Shift+arrow Select text or extend the selected text in the direction of the arrow. Shift+Home Select text or extend the selected text to the beginning of the current line. Shift+End Select text or extend the selected text to the end of the current line. Shift+Page Up Select text or extend the selected text up one full window of text. Shift+Page Down Select text or extend the selected text down one full window of text. Shift+Ctrl+Right Select text or extend the selected text to the beginning of the next word. Shift+Ctrl+Left Select text or extend the selected text to the beginning of the previous word. Shift+Ctrl+Home Select text or extend the selected text to the beginning of the document. Shift+Ctrl+End Select text or extend the selected text to the end of the document. Page Up Scrolls the document up one full window of text. Page Down Scrolls the document down one full window of text. For information on the assignment of accelerator keys to WebWriter/2 menu options, select one of the following topics.  File menu key assignments  Edit menu key assignments  Tags menu key assignments  Characters menu key assignments ═══ 3.1. File menu key assignments ═══ The following accelerator key assignments apply to File menu options. Ctrl+N Closes the current document, if any, and starts a new document. Ctrl+O Opens an existing document for editing. Ctrl+S Saves the current document. Ctrl+C Closes the current document. Ctrl+1 Preview the current document using the primary preview application. Ctrl+2 Preview the current document using the secondary preview application. Ctrl+0 Preview the current document using a preview application which you select. Ctrl+P Print the current document. F3 Close all WebWriter/2 windows and exit WebWriter/2. ═══ 3.2. Edit menu key assignments ═══ The following accelerator key assignments apply to Edit menu options. Alt+Backspace Undo the last change made to the document. Shift+Delete Remove the selected text and place it on the clipboard. Ctrl+Insert Copy the selected text to the clipboard. Shift+Insert Insert the contents of the clipboard at the insertion point. Delete Delete the selected text. Ctrl+/ Select the entire document. Ctrl+\ Deselect all text. Ctrl+F Display the Find dialog. ═══ 3.3. Tags menu key assignments ═══ The following accelerator key assignments apply to Tags menu options. Alt+1 Insert a Heading 1 tag (

    ). Alt+2 Insert a Heading 2 tag (

    ). Alt+3 Insert a Heading 3 tag (

    ). Alt+4 Insert a Heading 4 tag (

    ). Alt+5 Insert a Heading 5 tag (
    ). Alt+6 Insert a Heading 6 tag (
    ). Alt+B Insert a Bold text tag (). Alt+I Insert an Italic text tag (). Alt+U Insert an Undelined text tag (). Alt+T Insert a Typewriter text tag (). Alt+P Insert a Paragraph tag (

    ). Alt+C Insert a Center tag (
    ). Alt+R Insert a Horizontal rule tag (
    ). Alt+K Insert a Line break tag (
    ). Alt+. Insert a List item tag (
  • ). Alt+L Insert an Unordered list tag (). Alt+O Insert an Ordered list tag (
      ). Ctrl+T Display the Tag manager dialog. ═══ 3.4. Characters menu key assignments ═══ The following accelerator key assignments apply to Characters menu options. Alt+Shift+< Insert the character entity for the < sumbol. Alt+Shift+> Insert the character entity for the > sumbol. Alt+Shift+& Insert the character entity for the & sumbol. Alt+Shift+" Insert the character entity for a quotation mark. Alt+Space Insert the character entity for a non-breaking space. Alt+G If a character is selected, convert the selected character to the character entity for the selected character with a grave accent. If no character is selected, convert the previous character to the character entity for the previous character with a grave accent. Alt+A If a character is selected, convert the selected character to the character entity for the selected character with an acute accent. If no character is selected, convert the previous character to the character entity for the previous character with a acute accent. Alt+Shift+^ If a character is selected, convert the selected character to the character entity for the selected character with a circumflex accent. If no character is selected, convert the previous character to the character entity for the previous character with a circumflex accent. Alt+Shift+~ If a character is selected, convert the selected character to the character entity for the selected character with a tilde. If no character is selected, convert the previous character to the character entity for the previous character with a tilde. Alt+M If a character is selected, convert the selected character to the character entity for the selected character with an umlaut. If no character is selected, convert the previous character to the character entity for the previous character with an umlaut. ═══ 4. Help on menus ═══ For information about commands for a specific menu select one of the following:  File menu help  Edit menu help  Tags menu help  Attributes menu help  Characters menu help  Options menu help  Windows menu help  Help menu help  Context menu help ═══ 4.1. File menu help ═══ New This option will close the current document if any and provide an empty edit window to begin a new document. If a document is open and changes have been made the user will be prompted to save the open document. If a template is specified on the Template page of the WebWriter/2 settings notebook and Use template is selected the new document will be based on the template document. Open... Allows the user to select an existing document to edit. Save Saves the current document. Save as... Prompts the user for a path and file name and saves the current document to the path and file name specified. Close Closes the current document. The user is prompted to save the document if changes have been made. Import... Allows the user to select a document to import into the current document. The selected document will be inserted into the current document at the cursor location. Copy to... Copies the current document to a file specified by the user. Rename... Allows the user to rename the current document. Delete Deletes the current document. Preview Primary preview application View the current document using the WWW client specified as the primary preview application on the Preview app 1 page of the WebWriter/2 settings notebook. Secondary preview application View the current document using the WWW client specified as the secondary preview application on the Preview app 2 page of the WebWriter/2 settings notebook. Other... Select an application to preview the current document with. Print Document Prints the current document. Selected text Prints the selected text only. Printer setup... Displays the Printer setup dialog which allows you to select a printer and specify print options. Exit WebWriter/2 This will close all open WebWriter/2 windows. If you just want to close the current document window use Close from the System menu or double click the System menu icon. ═══ 4.2. Edit menu help ═══ Undo This will undo the last change to the document. Cut Cuts the selected text to the Clipboard. Copy Copies the selected text to the Clipboard. Paste Inserts the Clipboard contents. Delete Deletes the selected text. Select all Selects the entire document. Deselect all This will undo any text selection that exists. If no text is selected, this will have no effect. Find Displays the Find dialog. ═══ 4.3. Tags menu help ═══ Document Tags relating to document structure and attributes. Headings Tags for headings and titles. Character Physical & logical character formatting. Paragraph Tags relating to grouping and separating text elements. Lists Tags for defining lists and list elements. Links Tags to create links to HTML documents and other network resources. Images Tags to insert images. Forms Tags for creating forms. Tables Tags for creating tables. More tags... Displays the Tag manager dialog from which the user may define and select tags. ═══ 4.3.1. Document tags ═══ HTML document Document head Document title Document body[...] If you hold down the Ctrl key when selecting this menu option, you will be prompted to specify the attributes associated with the BODY element. HTML skeleton[...] Inserts a document skeleton. If there is selected text in the edit window this text will be wrapped by the BODY tags. If you hold down the Ctrl key when selecting this menu option, you will be prompted to specify the content of the the TITLE element and the attributes associated with the BODY element. Animate WE icon Animation frame... Document type Allows you to insert one of the following document type declarations: HTML v1.0 HTML v2.0 HTML v3.0 Other type Base URL... Searchable index Relationships... Meta-information... ═══ 4.3.2. Heading tags ═══ Heading 1

      Heading 2

      Heading 3

      Heading 4

      Heading 5
      Heading 6
      ═══ 4.3.3. Character formatting tags ═══ Bold text Italic text Underline text Typewriter text Font size... Emphasis Strong emphasis Code sample Keyboard input Variable Sample Citation ═══ 4.3.4. Paragraph formatting tags ═══ Paragraph

      Center text
      Horizontal rule[...]
      If you hold down the Ctrl key when selecting this menu option, you will be prompted to specify the attributes associated with the HR element. Line break[...]
      If you hold down the Ctrl key when selecting this menu option, you will be prompted to specify the attributes associated with the BR element. Block quote
      Address
      Preformatted 
      

 Comment 

            


═══ 4.3.5. List formatting tags ═══

 List item 

            
    1. 

 Unordered list 

            

 Ordered list 

            
        

 Menu list 

            

 Directory list 

            

 Glossary list 

            
        

 Glossary term 

            
        

 Term definition 

            
        


═══ 4.3.6. Link tags ═══

 Local link... 

            

 Local to anchor... 

            

 HTTP link... 

            

 HTTP to anchor... 

            

 Gopher link... 

            

 FTP link... 

            

 Newsgroup link... 

            

 Mailto address... 

            

 File link... 

            

 Anchor... 

            


═══ 4.3.7. Image tags ═══

 Inline image... 

            ... 


═══ 4.3.8. Form tags ═══

 Form... 

            
        

 Check box... 

            

 Radio button... 

            

 Image... 

            

 Submit button... 

            

 Reset button... 

            

 Entry field... 

            

 Password entry... 

            

 Multiline entry... 

            

 List box... 

            

 List box item...